Micron Document
Fox's Git Mirrors

Node / acehoss / mcp-server-youtube-transcript.git rns://e35de29a61974cd952fde3fe9c8500d5/acehoss/mcp-server-youtube-transcript.git


>YouTube Transcript Server

![smithery badge](https://smithery.ai/protocol/@kimtaeyoon83/mcp-server-youtube-transcript)

A Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video captions and subtitles through a simple interface.

Installing via Smithery

To install YouTube Transcript Server for Claude Desktop automatically via Smithery:

T282828
npx @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

Components

Tools

• get_transcript
• Extract transcripts from YouTube videos
• Inputs:
• T383838url (string, required): YouTube video URL or video ID
• T383838lang (string, optional, default: "en"): Language code for transcript (e.g., 'ko', 'en')

Key Features

• Support for multiple video URL formats
• Language-specific transcript retrieval
• Detailed metadata in responses

Configuration

To use with Claude Desktop, add this server configuration:

T282828
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}

Install via tool

mcp-get A command-line tool for installing and managing Model Context Protocol (MCP) servers.

T282828
npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

Awesome-mcp-servers
awesome-mcp-servers A curated list of awesome Model Context Protocol (MCP) servers.

Development

Prerequisites

• Node.js 18 or higher
• npm or yarn

Setup

Install dependencies:
T282828
npm install

Build the server:
T282828
npm run build

For development with auto-rebuild:
T282828
npm run watch

Testing

T282828
npm test

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for development:

T282828
npm run inspector

Error Handling

The server implements robust error handling for common scenarios:
• Invalid video URLs or IDs
• Unavailable transcripts
• Language availability issues
• Network errors

Usage Examples

1. Get transcript by video URL:
T282828
await server.callTool("get_transcript", {
url: "https://www.youtube.com/watch?v=VIDEO_ID",
lang: "en"
});

2. Get transcript by video ID:
T282828
await server.callTool("get_transcript", {
url: "VIDEO_ID",
lang: "ko"
});

3. How to Extract YouTube Subtitles in Claude Desktop App
T282828
chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

Security Considerations

The server:
• Validates all input parameters
• Handles YouTube API errors gracefully
• Implements timeouts for transcript retrieval
• Provides detailed error messages for troubleshooting

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

Served by rngit 1.4.1 - Generated in 0.03s